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1 . INTRODUCTION 

NETLDR is used to downline load remote nodes from the DECsystem-10, 
and to dump the memory of a remote node onto a file on the 
DECsystem-10. NETLDR cannot be run until a 'load request 1 has been 
received from the remote node (this is initiated at the remote 
node - see the DECsystem-10 Networks Software Installation Guide) . 
The user must be logged in as [1,2] and have POKE, LOCK and HPQ 
privileges enabled to run NETLDR. 



NOTE 

NETLDR cannot be scheduled to run 
automatically if the command SET SCHED 
1000 has been executed. 



2.0 COMMAND FORMAT 

The format for commands to NETLDR is: 

f ilespec/CPUtype/NODE:nodeid/LINE: syn#/switch/switch . . . 
where: 

filespec = dev: filename .ext [p,pn] 

CPUtype = /PDP11,/11,/PDP8 or /8 

nodeid = node name (up to six characters) or a node number 
(octal value 01 to 77) 

syn# = synchronous line from adjacent node to node of 
interest (0 to 12) [to dump a node, replace /LINE: 
with /SELF; /SELF cannot be used with /LOAD] 

/switches are optional. 

Entries in the SYS:NETLDR. INI file are as specified in Section 3.1, 
"NETLDR.INI". 



3.0 FILE SPECIFICATIONS 

Files to be loaded or to accept dumps are specified for use by NETLDR 
in the following form: 

dev: filename .ext [p,pn] 



Only the filename is required. The defaults are: 
Entry Default 

filename for 

dumping nodeid.LSD 

extension .BIN for loading 

.LSD for dumping 

device DSK: SYS: 

p,pn the p,pn whereyou are logged in, or 

[10,0] if you are not logged in. 

CPUtype /PDP11 

if CPUtype is PDP-11 /PACKED 

if node CPUtype is PDP-8 /IMAGE 



3.1 NETLDR.INI 

When a remote node is first started (in its bootstrap ROM) , it sends a 
BOOT request over one of its synchronous lines. The node at the other 
end of the line receives the request and routes it to a node with an 
"MCR" device (that is, to a TOPS-10 host). 

When the host receives the boot request, it automatically starts a 
copy of NETLDR running (detached, not logged in) unless: 

• SCHED 1000 is set 

• or the system was brought up with DEBUGF set. 

The running NETLDR then reads the boot request, and finds the name of 
the node that received the request, the line number that received the 
request, and the node type and serial number of the originating node. 
With this information, it reads NETLDR.INI trying to match the 
received data and a string to the left of the equal sign ( = ) . 
NETLDR.INI must contain a single command line for each node to be 
loaded or dumped. This command line must be in the following form: 

/NODE :a/LINE:b/TYPE:c/SERIAL:nnn=dumpf ile spec/switches, 
loadf ile spec /switches 

where: 

a is a nodeid 

b is a synchronous line number 

c is a station type 

nnn is a "serial" number unique to a node 

dumpfilespec is the specification of the file in which a dump 
is stored 

loadfilespec is the specification of the file to be loaded. 



Entries on the left side of the equation specify the node adjacent to 
the node to be loaded, the adjacent node's line, the type of the node 
to be loaded, and its CPUtype (if not a PDP-11). Entries are scanned 
and executed from left to right. For example, the following entries 
make up a NETLDR.INI file: 

/TYPE:DC7 2=XPNN:D7213?/D/HPQ:1,SYS:DC7 213 

/NODE: NOVA/LINE : 0/TYPE: DN82=XPNN : D8222P/D: 0-137 7 76/HPQ.-1, SYS :DN8222 

/NODE: NOVA/LINE : 1/TYPE : DN82=XPNN : D82227/D: 0-137 776/HPQ:l, SYS :DN8222 

/NODE:45=/IGNORE 

/TYPE : DN9 2=/IGNORE 
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NOTE 


NETLDR.INI must 


not contain line numbers 


or blank lines. 





4.0 NETLDR SWITCHES 

The switches available to NETLDR are: 



/DUMP:x-y 



Dumps remote node memory from location x to 
location y to the file 
dev: filename .LSD [p,pn] ; default locations 
are : 



PDP-8 
PDP-11 



TO 17777 
TO 77776 



/EXIT 

/HELP 
/HPQ:q 



The default dump device, filename 
XPN:nodeid.LSD, where XPN=[10,1]. 



is 



Exits from NETLDR; equivalent to CTRL/C 
(~C) . 

Outputs the NETLDR HELP file. 

Specifies the high priority queue number. To 
have the running of NETLDR take precedence 
over time sharing (where HPQ=0) , set HPQ=1 or 
some higher number. This switch can only be 
used if #HIGH PRIORITY QUEUES set at 
MONGEN (HDWGEN) time is nonzero and you have 
HPQ privileges. This switch must be on the 
right side of the equation. 



/IGNORE* 
/IMAGE 

/LINE:syn# 

/LOAD 
/PACKED 

/PDP8 

/8 

/PDP11 

/ll 
/SELF 

/SERIAL: ser* 



/START: addr 
/TYPE: type* 



Ignore (do not process) load requests from 
the specified node. 

Specifies that the .BIN file referenced is in 
image format (for a PDP-8) ; this is the 
default for a PDP-8. 

Specifies synchronous line number (in octal) 
from adjacent node which is to be used to 
load the desired node (see Figure 1-1) . 



Load software but 
default) . 



do not start it (the 



Specifies that the .BIN file referenced is in 
packed format. This is the default for 
PDP-11 files; it is illegal for PDP-8 files. 

Specifies a PDP-8. 

Specifies a PDP-8. 

Specifies a PDP-11 (the default in a 
NETLDR.INI command). 

Specifies a PDP-11. 

Specifies that the dump is to be carried out 
on the node itself. 

Specifies the serial number of the remote 
node processor. The serial number provided 
by the remote node request-to-load message 
must match the serial number specified in 
NETLDR.INI. 

Starts program at address addr. 

Specifies node type as DN80, DN81, DN82, DN92 
or DC72. 



*This switch can only be used in NETLDR.INI. 
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Figure 1-1 Loading a Remote Node 



5.0 RUNNING NETLDR 

When running NETLDR, you must be logged in as [1,2] and have LOCK and 
POKE and HPQ privileges. To run NETLDR, execute the following 
command : 

.R NETLDR 
The program prompts with: 

FILE; 

Enter a filespec, nodeid, synchronous line number and any switches. 

For example, to downline load a file called DN8222 for a DN82 station 
called node 22 from node 10 over line 4, enter the following response 
to the FILE prompt: 

BLKA:DN8222/NODE: 10/LINE: 4/PDP11 

In this example, the file DN8222 has been stored on device BLKA: . 
Once downline loading is complete, the following message appears at 
the DN82 CTY: 

INITIALIZING DN82 Vll(23) DEC 1977-DN8222 ( 22) 

node type 

version of software 

date 

node name 

node number 

Entries in a NETLDR.INI file to load node YIN from node YANG over line 
of node YIN (line 1 of node YANG) and to prevent loads from node 45 
would contain the following entries: 

/NODE : YANG/LINE :1/TYPE: DN82=XPNN : D826 6 ?/D: 0-137776/HPQ :1,- 
SYS:DN8266 ILoad YIN from YANG over Line 
/NODE:45/IGNORE ! Ignore load requests from node 45 



NOTE 

The minus sign (-) following HPQ-.1, is 
for line continuation in NETLDR.INI. 



The entry to load node YIN also specifies that node YIN is a DN82, 
that a dump of locations 0-137776 is to be taken, placed in a file 
with the highest generation number on XPNN:D8266?, and that the file 
to be loaded must be taken from SYS:DN8266. The /HPQ switch is used 
to allow the dump request (/HPQ=1) to take precedence over normal time 
sharing. 



6.0 ERROR MESSAGES 

All error messages generated by NETLDR are preceded by either ? 
(fatal error) or % (nonfatal error) and the three characters NET. 
These characters are followed by three characters which can be used to 
reference the source code through a CREF listing. For example, given 
the following error message: 



7NETCME command error 

examine your NETLDR CREF listing 
section, for the entry S.CME. 



looking, in the crossref erence 



S.CME gives the line number where the source code that generates 
error message appears. 



the 



The error messages returned from NETLDR that are self-explanatory are 
listed below. If other error messages appear, there is either a 
problem with the binary file you are trying to load, or there is a 
major problem with network software. Contact your systems programmer 
or software specialist for assistance. The self-explanatory error 
messages (in alphabetical order by NET... name) are: 



Table 1-1 
NETLDR Error Messages (partial list) 



Name 



Meaning 



ABS 
BLN 
BTN 
CLR 
CME 
CSR 
FNM 
FSM 
HPQ 
IDV 
IFU 
ILC 
INN 
IPN 
ISA 
ISC 
ITN 
ITY 
LCK 
LSR 
LTL 
LTS 
NOT 
NMI 
NSR 
NSS 
OAI 
ODD 
POK 
SIL 
SMA 
SNG 
UNS 



Ambiguous switch 

Illegal line number 

Illegal Type name 

/CLEAR is not yet implemented 

Command error 

/PDP8 or /PDP11 switch required 

Filename missing 

File-spec missing 

Cannot put job in HPQ 

Double value illegal for switch 

Illegal function 

Illegal character 

Illegal node number 

Illegal PN (dump device must be XPN) 

Illegal switch argument 

Illegal switch combination 

Illegal Type number 

Illegal TYPE 

Must have LOCK privileges 

/LINE or /SELF switch required 

Line number greater than 17 (octal) 

Last address to dump too small 

Must be logged in as [1,2] 

Cannot find match in SYS :NETLDR. INI 

Node switch required 

No switches specified 

Odd dump address illegal 

Cannot start at an odd address 

Must have POKE privileges 

Illegal switches left of equal 

Argument required for switch 

No meaning for switch 

Unknown switch 
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